home *** CD-ROM | disk | FTP | other *** search
/ Collection of Internet / Collection of Internet.iso / infosrvr / doc / www_talk.arc / 000281_timbl@www3.cern.ch _Sun Nov 1 16:56:50 1992.msg < prev    next >
Internet Message Format  |  1992-11-30  |  2KB
  1. Return-Path: <timbl@www3.cern.ch>
  2. Received: from dxmint.cern.ch by  nxoc01.cern.ch  (NeXT-1.0 (From Sendmail 5.52)/NeXT-2.0)
  3.     id AA02791; Sun, 1 Nov 92 16:56:50 MET
  4. Received: by dxmint.cern.ch (dxcern) (5.57/3.14)
  5.     id AA13733; Sun, 1 Nov 92 17:08:55 +0100
  6. Received: by www3.cern.ch (NX5.67c/NX3.0S)
  7.     id AA00294; Sun, 1 Nov 92 17:06:08 +0100
  8. Date: Sun, 1 Nov 92 17:06:08 +0100
  9. From: Tim Berners-Lee <timbl@www3.cern.ch>
  10. Message-Id: <9211011606.AA00294@www3.cern.ch>
  11. Received: by NeXT.Mailer (1.87.1)
  12. Received: by NeXT Mailer (1.87.1)
  13. To: Edward Vielmetti <emv@msen.com>
  14. Subject: Re: question and answer, style guide?
  15. Cc: www-talk@nxoc01.cern.ch
  16. Reply-To: timbl@nxoc01.cern.ch
  17.  
  18. > Can someone suggest a good style for a 'frequently asked questions,
  19. > with answers' document?  
  20.  
  21.  
  22. The W3 FAQ have a <UL>...</UL> list of questions which are linked to
  23. a page each of which has a H1 summary heading,
  24. and an H@ "Question" thena a few paragraphs of question and an H2
  25. with a heading appropriate for the answer and n paragraphs of
  26. answer.
  27.  
  28. If you want to put all the FAQ on one document (will this scale?)
  29. then I would suggest making the questions H2 level headings, and
  30. the text ordinary text. H2 headings are normally bold and bug and  
  31. left-justified on X dipslays.
  32.  
  33. The advantage with using headings for the questions instead of
  34. DT glossary parts is that that you are free to use glossaries,lists and
  35. examples within the answer.
  36.  
  37. > I think I'd like to distinguish the questions from the answers by
  38. > indenting, at least in the 24x80 dumb terminal that I'm working with,
  39. > but I also want to make sure that things look ok under X.
  40.  
  41. Sounds like somone ought to be buying you a workstation for Christmas :-)
  42. But I realize that users tend not to use/have X, even now.
  43.  
  44.     Tim BL